/**
 * @(#)CompensadorManager.java Mar 18, 2007
 *
 * Copyright (c) 2005-2010 Psiqueware S.A. de C.V. All Rights Reserved.
 * This software is the proprietary information Psiqueware S.A. de C.V.
 * Use is subject to license terms.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *
 * <br/>Usuario : Psique
 * <br/>Creaci&oacute;n: Mar 18, 2007 - 2:27:16 PM
 * <br/>
 * <br/>
 * <br/><t5>Cambios :</t5>
 * <br/><b>Fecha | Autor  |  Cambios</b>
 * <ul>
 * <li>Mar 18, 2007 | <a href = "mailto:AngelElectrico@PsiqueWare.com">Psique</a> | Creaci&oacute;n del Objeto.</li>
 * <li>Abr 19, 2007 | <a href = "mailto:AngelElectrico@PsiqueWare.com">Psique</a> | Se eliminar&oacute;n las referencias a las clases Empresa, Deportamento, etc y se cambiar&oacute;n por referencias a Estructura.</li>
 *
 * </ul>
 */

package com.psiqueware.jazmin.empresas.recursos.humanos.compensaciones;

import com.psiqueware.alheli.dao.EnlaceTransaccional;
import com.psiqueware.alheli.manager.BaseManagerInterface;
import com.psiqueware.alheli.manager.ManagerException;
import com.psiqueware.alheli.seguridad.Actividad;
import com.psiqueware.alheli.seguridad.SeguridadManagerFactory;
import com.psiqueware.jazmin.empresas.recursos.humanos.Asignacion;
import com.psiqueware.jazmin.empresas.recursos.humanos.Empleado;
import com.psiqueware.tulipan.organizacional.Estructura;

import java.math.BigDecimal;

/**
 * Encargado de la operaciones de compensaciones de los empleados.
 * <br/>Paquete Original: com.psiqueware.laVIE.empresas.recursos.humanos.compensaciones
 * <br/>Nombre  Original: CompensadorManager
 * <br/>Oprima para ver : <a href="CompensadorManager.java.html"><i>C&oacute;digo Fuente</i> </a>
 *
 * @author <a href="mailto:AngelElectrico@PsiqueWare.com">Psique</a>
 * @version Revision: 1.1 Mar 18, 2007 2:27:16 PM
 */
public interface CompensadorManager extends BaseManagerInterface
{

    /** Actividad de incrementar un {@link Sueldo}. */
    Actividad m_incrementarSueldo = SeguridadManagerFactory.getActividad ( "Poder para realizar aumentos de Sueldo.", CompensadorManager.class );

    /**
     * Propone un {@link Incremento} para un {@link RegistroEmpleado}.
     * Es necesario que no se tenga un {@link IncrementoPropuesto} de gerente
     * ya en el {@link RegistroEmpleado}; si se tiene el m&eacute;todo devolver&aacute; <code>null</code>.
     *
     * @param registroEmpleado    {@link RegistroEmpleado} donde se pretende proponer el {@link Incremento}.
     * @param incremento          propuesto.
     * @param gerente             que autoriza la transacci&oacute;n.  Si no tiene la seguridad inicializada el m&eacute;todo la inicializa.
     * @param enlaceTransaccional para asegurar la atomicidad de la transacci&oacute;n.
     *
     * @return el {@link IncrementoPropuesto} en caso de poderse proponer; <code>null</code> en caso contrario.
     *
     * @exception com.psiqueware.alheli.manager.ManagerException
     *             en caso de no poder completar la operaci&oacute;n.
     */
    IncrementoPropuesto proponerIncremento ( RegistroEmpleado registroEmpleado, Incremento incremento, Empleado gerente, EnlaceTransaccional enlaceTransaccional ) throws ManagerException;

    /**
     * Genera un {@link RegistroEmpleado} para la {@link Asignacion} y {@link EstructuraSalarial} dada.
     *
     * @param asignacion          a la cual obedece actualmente el {@link Empleado}.
     * @param estructuraSalarial  que tiene asignado.
     * @param enlaceTransaccional para asegurar la atomicidad de la transacci&oacute;n.
     *
     * @return nuevo {@link RegistroEmpleado} para el {@link Empleado} de la {@link Asignacion}.
     *
     * @exception com.psiqueware.alheli.manager.ManagerException
     *             en caso de no poder completar la operaci&oacute;n.
     */
    RegistroEmpleado registraEmpleado ( Asignacion asignacion, EstructuraSalarial estructuraSalarial, EnlaceTransaccional enlaceTransaccional ) throws ManagerException;

    /**
     * Da de alta una nueva {@link EstructuraSalarial} para la Empresa dada.
     *
     * @param estructura             Empresa a la que pertenecer&aacute; la {@link EstructuraSalarial}.
     * @param clave               para identificarla de otras estructuras.
     * @param enlaceTransaccional para asegurar la atomicidad de la transacci&oacute;n.
     *
     * @return {@link EstructuraSalarial} nueva.
     *
     * @exception com.psiqueware.alheli.manager.ManagerException
     *             en caso de no poder completar la operaci&oacute;n.
     */
    EstructuraSalarial nuevaEstructuraSalarial ( Estructura estructura, String clave, EnlaceTransaccional enlaceTransaccional ) throws ManagerException;

    /**
     * Agrega un nuevo {@link GradoRangoSalarial} a la {@link EstructuraSalarial} dada. Lo ordena y reordena deacuerdo al valor de minimo.
     *
     * @param estructuraSalarial  a la que se le va a agregar el {@link GradoRangoSalarial}.
     * @param clave               para distinguir el {@link GradoRangoSalarial}.
     * @param minimo              del Rango.
     * @param media               del Rango.
     * @param maximo              del Rango.
     * @param enlaceTransaccional para asegurar la atomicidad de la transacci&oacute;n.
     *
     * @return el nuevo {@link GradoRangoSalarial}.
     *
     * @exception com.psiqueware.alheli.manager.ManagerException
     *             en caso de no poder completar la operaci&oacute;n.
     * @noinspection OverlyStrongTypeCast,OverlyComplexMethod
     */
    GradoRangoSalarial agregarGradoRangoSalarial ( EstructuraSalarial estructuraSalarial, String clave, BigDecimal minimo, BigDecimal media, BigDecimal maximo, EnlaceTransaccional enlaceTransaccional ) throws ManagerException;
}
